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FOREWORD 


This  technical  report  covers  work  performed  under  Air  Force 
Contract  F33600-87-C-0464,  DAPro  Project.  This  contract  is 
sponsored  by  the  Manufacturing  Technology  Directorate,  Air  Force 
Systems  Command,  Wright-Patterson  Air  Force  Base,  Ohio.  It  was 
administered  under  the  technical  direction  of  Mr.  Bruce  A. 
Rasmussen,  Branch  Chief,  Integration  Technology  Division, 
Manufacturing  Technology  Directorate,  through  Mr.  David  L.  Judson, 
Project  Manager.  The  Prime  Contractor  was  Integration  Technology 
Services,  Software  Programs  Division,  of  the  Control  Data 
Corporation,  Dayton,  Ohio,  under  the  direction  of  Mr.  W.  A. 
Osborne.  The  DAPro  Project  Manager  for  Control  Data  Corporation 
was  Mr.  Jimmy  P.  Maxwell. 

The  DAPro  project  was  created  to  continue  the  development,  test, 
and  demonstration  of  the  Integrated  Information  Support  System 
(IISS) .  The  IISS  technology  work  comprises  enhancements  to  IISS 
software  and  the  establishment  and  operation  of  IISS  test  bed 
hardware  and  communications  for  developers  and  users. 

The  following  list  names  the  Control  Data  Corporation 
subcontractors  and  their  contributing  activities: 


SUBCONTRACTOR 


ROLE 


Control  Data  Corporation 


D .  Appleton  Company 


ONTEK 


Simpact  Corporation 


Structural  Dynamics 
Research  Corporation 


Arizona  State  University 


Responsible  for  the  overall  Common 
Data  Model  design  development  and 
implementation,  IISS  integration  and 
test,  and  technology  transfer  of  IISS. 

Responsible  for  providing  software 
information  services  for  the  Common 
Data  Model  and  IDEFIX  integration 
methodology . 

Responsible  for  defining  and  testing  a 
representative  integrated  system  base 
in  Artificial  Intelligence  techniques 
to  establish  fitness  for  use. 

Responsible  for  Communication 
development . 

Responsible  for  User  Interfaces, 
Virtual  Terminal  Interface, and  Network 
Transaction  Manager  design, 
development,  implementation,  and 
support . 

Responsible  for  test  bed  operations 
and  support . 
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SECTION  1 
SCOPE 


1 . 1  Identification 


This  specification  establishes  the  design  of  Function  DRS, 
"Distributed  Request  Supervisor",  one  of  the  major  functions  of 
the  Configuration  Item,  to  be  built  and  formally  accepted  by  the 
ICAM  Program  Office.  This  Cl  constitutes  one  of  the  subsystems 
of  the  Common  Data  Model  Processor  (CDMP) . 


1.2  Functional  Summary 

The  overall  objectives  of  this  CPCI  are  to: 

1.  Determine  the  appropriate  sequence  of  inter  database 
Join,  Union  and  Outer  Join  operations  required  to 
produce  the  result  for  a  multi-database  transaction. 

2.  Coordinate  and  control  the  interactions  among  a  user's 
application  process  (AP) ,  the  generated  Request 
Processor  (RP)  and  the  Aggregator ( s )  for  both  single 
and  multi-database  transactions. 
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SECTION  2 
DOCUMENTS 


2 . 1  Reference  Documents 


1.  ICAM  Documentation  Standards;  IDS15012000A,  28 
December  1981. 

2.  D.  Appleton  Co,  CDM  Administrators  Manual;  UM620141000. 
March  1984. 

3.  D.  Appleton  Co.,  CDMl-IDEFl  Model  of  the  Common  Data 
Model;  CCS620141000 ,  15  May  1985. 

4.  D.  Appleton  Co.,  Computer  Program  Development 
Specification  (PS)  for  Integrated  Support  System  (IISS) 
Configuration  Item;  NDML  Precompiler;  DS620141200, 
October  1984. 

5.  D.  Appleton  Co.,  Embedded  NDML  Programmer's  Reference 
Manual;  PRM620141200,  March  1985. 

6.  Softech,  Inc.,  NTM  Programmer's  Guide:  UM62 014 0001, 
July  1984 

7.  Control  Data  Corporation,  Computer  Program  Development 
Specification  (DS|  for  ICAM  Integrated  Support  System 
(IISS)  Configuration  Item;  NDDL  Command  Processor; 
DS620141100,  June  1985. 


2 . 2  Terms  and  Abbreviations 

Attribute  Use  Class:  (AUC) 

Conceptual  Schema;  (CS) 

Common  Data  Model  Processor;  (CDMP) 

Common  Data  Model;  (CDM)  Describes  common  data  application 
process  formats^  form  definitions,  etc. ,  of  the  IISS  and  includes 
conceptual  schema,  external,  internal  schemas,  and  schema 
transformation  operators. 

Data  Field;  (DF)  An  element  of  data  in  the  external 
schemal  It  is  by  this  name  that  an  NDML  programmer  reference 
data. 


Database  Management  System;  ( DBMS ) 

Distributed  Reguest  Supervisor;  (DRS)  This  IISS  CDM 
subsystem  configuration  item  controls  the  execution  of 
distributed  NDML  queries  and  non  distributed  updates. 

Domain;  A  logical  definition  of  legal  attribute  class 
values. 
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Domain  Constraint;  Predicate  that  applies  to  a  single 
domain. 

External  Schema;  (ES) 

Forms;  Structured  views  which  may  be  imposed  on  windows  or 
other  foj*ms.  A  form  is  composed  of  fields  where  each  field  is  a 
form,  item,  or  window. 

Forms  Processor:  (FP)  A  set  of  callable  execution  time 
routimes  available  to  an  application  program  for  form 
processing. 

Internal  Schema;  (IS) 

Integrated  Information  Support  System;:  (IISS)  A  test 
computing  environment  used  to  investigate,  demonstrate,  and  test 
the  concepts  of  information  management  and  information 
integration  in  the  context  of  Aerospace  Manufacturing.  The  IISS 
addresses  the  problems  of  integration  of  data  resident  on 
heterogeneous  databases  supported  by  heterogeneous  computers 
interconnected  via  a  local  Area  Netwrok. 

Mapping;  The  correspondence  of  independent  objects  in  two 
schemas;  ES  to  Cs  or  CS  to  IS. 

Network  Transaction  Manager;  (NTM)  Performs  the 
coordination,  communication,  and  housekeeping  functions  required 
to  integrate  the  application  processes  and  system  services 
resident  on  the  various  hosts  into  a  cohesive  system. 

Neutral  Data  Manipulation  Lanquac^e;  (NDML)  A  language 
developed  by  the  IISS  project  to  provide  uniform  access  to 
common  data,  regardless  of  database  manager  or  distribution 
criteria.  It  provides  distributed  retrieved  and  single  node 
updates . 

ORACLE ;  Relational  DBMS  based  on  the  SQL  (Structured  Query 
Language,  a  product  of  ORACLE  Corp. ,  Menlo  Park,  CA) .  The  CDM  is 
an  ORACLE  database. 

Parcel ;  A  sequential  file  containing  sections  source  code 
of  the  input  application  program. 

Request  Processor:  (RP)  A  COBOL  program  that  will  satisfy 
a  retrieval  or  update  NDML  subtransaction  against  a  particular 
Database  Management  System. 

User  Interface;  (UI)  Controls  the  user's  terminal  and 
interfaces  with  the  rest  of  the  system. 

Virtual  Terminal  Interface;  (VTI)  Performs  the  interfacing 
between  different  terminals  and  the  UI.  This  is  done  by 
defining  a  specific  set  of  terminal  features  and  protocols  which 
must  be  supported  by  UI  software  which  constitutes  the  Virtual 
Terminal  Definition.  Specific  terminals  are  then  mapped  against 
the  Virtual  Terminal  software  by  specific  software  modules 
written  for  each  type  of  real  terminal  supported. 
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REQUIREMENTS 


3 . 1  Structural  Description 

A  graphic  portrayal  of  this  CPCI  is  included  in  Section 
3.10.  This  chart  shows  the  hierarchical  relationship  of  each 
module  making  up  this  CPCI. 

The  DRS  has  been  coded  as  a  COBOL  subprogram  with  supporting 
subprograms . 

It  is  internally  composed  of  three  subfunctions  and  defined 
in  the  DS  Reference  8.  These  subfunctions  are: 

1.  Initiate/Resume  Subtransaction  Processing 

2 .  Schedule  Stages 

3.  Initiate  CS/ES  Transform  Processing 


3 . 2  Functional  Flow 

This  CPCI  implements  the  logic  defined  in  the  Development 
Specification  for  this  CPCI.  Details  of  inputs/ outputs  and 
relationships  between  modules  are  to  be  found  in  Section  3.10. 

This  CPCI  has  been  designated  to  operate  in  an  interactive 
mode.  It  must  operate  in  the  system  environment  established  for 
IISS;  that  is,  use  of  the  Network  Transaction  Manager. 

The  following  exceptions  to  the  Development  Specification 
are  noted. 

1.  The  DS  calls  for  the  CS/ES  transform  step  to  be 
controlled  by  the  DRS  as  a  separate  process,  using  file 
input-output  and  NTM  interprocess  communication.  In 
interests  of  efficiency,  the  CS/ES  transform  is 
controlled  by  code  generated  into  the  user  AP  directly. 
This  saves  one  file  of  external  query  results  and 
allows  the  interaction  with  the  CS/ES  transform  to  be 
direct,  without  use  of  NTM  services. 

2.  The  DS  called  for  the  DRS  to  be  a  separate  process.  In 
the  interests  of  efficiency,  it  has  been  implemented  as 
a  subprogram  called  from  the  user's  AP. 

3.  The  contents  of  Transmission  Cost  Table  are  compiled 
into  the  DRS.  The  DRS  specifies  that  this  be  found  in 
a  file. 
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3 . 3  Interfaces 


The  following  diagram  depicts  the  interface  of  DRb  and  the 
other  CPCI's. 

+ - + 

USER  I 

AP  + - 

+ - + - + 

SUBROUTINE 
CALLS 

+ - + - + 

DRS  I 
+-+-+ - + 

+ - +_+ - +  ntm  services 

REQUEST 
PROCESSORS 
+ - + 


+ - + - + 

FILE  UTILITIES 
PS620141330 
+ - + 


+ - + - + 

AGGREGATORS 
PS620141320 
+ - + 


+ 


+ - + - + 

CS  ES 

TRANSFORMERS 
+ - + 


3.3.1  Input/Outputs 

The  following  table  depicts  the  inputs  and  outputs  of  this 
CPCI.  A  detailed  description  for  each  Item  can  be  found  in  the 
DS  for  this  CPCI. 

FUNCTION :  DRS 

_ INPUT _ OUTPUT 


Subtransaction  Number 

DRS  Action  Conceptual  Schema 

Result  File 

Pool  of  Input  Tables  from  Results  Count 

the  Users  Application  Process  Module  Status 

CS  Active  List 

Join  Query  Graph 

Attribute  Pair  List 

Results  Field  Table 


3 . 4  Program  Interrupts 

The  DRS  makes  use  of  NTM  services  to  start  and  control 
multiple  request  processors  at  the  same  time.  It  also  controls 
multiple  instances  of  aggregators  at  the  same  time.  It  must 
wait  until  each  process  has  completed  before  it  can  begin  its 
next  sequence  of  activities. 
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3 . 5  Timing  and  Secfuencinq  Description 

The  DRS  can  control  many  request  processors  at  the  same 
time,  asynchronously.  In  other  words,  it  will  start  all 
subtransactions  of  a  query  and  wait  for  them  all  to  complete. 
When  complete,  it  handles  aggregation  of  these  results.  The 
aggregation  may  also  execute  asynchronously  in  parallel.  The 
DRS  will  wait  for  all  processes  to  complete.  It  has  no  time 
limits. 


3 . 6  Special  Control  Features 
Not  applicable  to  this  CPCI. 

3 . 7  Storage  Allocation 

3.7.1  Database  Definition 

No  databases  are  used  by  this  CPCI. 


3. 7. 1.1  File  Description 

No  permanent  files  have  been  defined  for  this  CPCI.  It  may 
use  temporary  scratch  files  for  such  things  as  generated  program 
source  code  or  temporary  query  results.  The  cost  information 
table  has  not  been  implemented  as  a  file. 


3. 7. 1.2  Table  Description 

All  tables  used  by  this  CPCI  have  been  defined  by  the 
Development  Specification  for  this  CPCI. 

3. 7. 1.3  Item  Description 

Not  applicable  to  this  CPCI. 


3 . 8  Object  Code  Creation 

The  object  code  for  this  CPCI  will  be  created  by  the  system 
integration  test  team  by  using  defined  IISS  Software 
Configuration  Management  procedures.  This  CPCI  will  use  the 
COBOL  language  compiler. 


3 . 9  Adaptation  Data 

This  CPCI  has  been  coded  using  ANSI  COBOL.  The  intent  was 
to  provide  a  transportable  system.  Any  system  environment 
supporting  this  language,  a  virtual  memory  management  scheme, 
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the  COMM  and  NTM  subsystems  of  IISS  and  the  ORACLE  Database 
Management  System  should  be  able  to  support  this  CPCI .  Every 
possible  attempt  has  been  made  to  localize  and  identify  any 
machine  or  environment  dependent  modules  through  the  original 
design  of  the  IISS  and  application  of  Configuration  Management 
Procedures . 

3 . 10  Detail  Design  Description 

The  following  sections  have  been  computer  generated  for 
this  CPCI. 


3.10.1  Where  Include  File  Used  List 

The  following  lists  each  include  file  in  the 
documentation  group  and  all  the  modules  documented  in  this 
specification  which  include  them.  The  purpose  of  each 
module  is  listed  as  well. 

DOCGROUP  PS41310  Where-include-f ile-used  List 


Include 

File 

ERRCDM 

CHKCDM 

ERRPRO 


TCTABLE 

CITABLE 

RITABLE 

QITABLE 

SUBPROC 

RFTABLE 

STDRESP 

SRVRET 


Module 

Name 


CDFUNC 
CDLSC 
CDS  01 
TOTOPN 
TRMDML 

CDFUNC 

TOTOPN 

TRMDML 

CDFUNC 

CDLSC 

CDSOl 

TOTOPN 

TRMDML 

CDSOl 

CDSOl 

CDSOl 

CDSOl 

CDSOl 

CDSOl 

CDSOl 
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DOCGROUP  PS41310  Where-include-f ile-used  List 


Include 

Module 

File 

Name 

CDS  01 

FSMSG 

CDS  01 

AGGMSG 

CDS  01 

CSAL 

CDS  01 

JQGTBL 

CDS  01 

APL 

CDS  01 

LNKEDGE 

CDSOl 

DUMPCIT 

CDS  01 

DUMPRIT 

CDSOl 

DUMPAPL 

CDSOl 

DUMPRFT 

CDSOl 

DUMPJQG 

CDSOl 

DMPCSAL 

CDSOl 

STDTYP 

CDGTUSR 

FPD 

CDGTUSR 

FPCODE 

CDGTUSR 
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DOCGROUP  PS41310  Where-include-f ile-used  List 


Include 

Module 

File 

Name 

NDDL 

CDGTUSR 

OK 

CDGTUSR 

3.10.2  Where 

External  ] 

The  following  lists  each  external  function  or  routine 
in  the  documentation  group  and  all  the  documented  modules 
which  call  it.  The  purpose  of  each  module  is  listed  as 
well . 

DOCGROUP  PS41310  Where-external-routine-used  List 


System 

Module 

Module 

Name 

ERRPRO 

CDFUNC 
CDLSC 
CDS  01 
TOTOPN 
TRMDML 

RPMAIN 

CDLSC 

SIGERR 

CDSOl 

WHTHST 

CDS  01 

GETUSR 

CDSOl 

CHKMSG 

CDSOl 

RCV 

CDSOl 

ASCTIM 

CDSOl 

NSEND 

CDSOl 

ISEND 

CDSOl 

CDJSl 

CDSOl 

CDUSl 

CDSOl 

CDOJSl 

CDSOl 

DELFIL 
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DOCGROUP  PS41310  Where-external-routine-used  List 


System 

Module 

Module 

Name 

CDS  01 

SIGABT 

CDS  01 

OPENX 

TOTOPN 

TRMNAT 

TRMDML 

STRNCPY 

CDGTUSR 

STRFILL 

STRLEN 

CDGTUSR 

MEMCPY 

CDGTUSR 

STRNCMP 

CDGTUSR 

3.10.3  Main 

Program  Parts 

The  following  lists  each  Main  Program  in  the 
documentation  group  and  all  the  modules  which  are  called 
either  by  that  module  itself  or  by  any  of  the  documented 
modules  which  it  calls.  It  is  possible  for  a  non-main 
module  to  be  listed  more  that  once  if  it  is  called  by 
multiple  modules.  The  called  modules,  in  this  case  known  as 
program  parts,  are  marked  as  to  whether  they  are  documented 
here.  If  so,  the  phrase  "well-defined  module"  appears  by 
the  module  name,  if  not  it  is  an  "external  "routine".  The 
Purpose  of  the  Main  Program  module  is  listed  as  well. 
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DOCGROUP 

Main  Pgm 
Name 

CDFUNC 

CDGTUSR 

CDLSC 


CDS  01 


INTFTN 

STRFILL 


PS41310  Main  Program  Parts  List 


Module 

Module 

Name 

Type 

ERRPRO 

External 

routine 

STRNCPY 

External 

routine 

STRLEN 

External 

routine 

MEMCPY 

External 

routine 

STRNCMP 

External 

routine 

ERRPRO 

External 

routine 

RPMAIN 

External 

routine 

ERRPRO 

External 

routine 

SIGERR 

External 

routine 

CDGTUSR 

External 

routine 

WHTHST 

External 

routine 

GETUSR 

External 

routine 

CHKMSG 

External 

routine 

RCV 

External 

routine 

ASCTIM 

External 

routine 

CDLSC 

External 

routine 

NSEND 

External 

routine 

ISEND 

External 

routine 

CDFUNC 

External 

routine 

CDJSl 

External 

routine 

CDUSl 

External 

routine 

CDOJSl 

External 

routine 

DELFIL 

External 

routine 

SIGABT 

External 

routine 

STRNCPY 

External 

routine 
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DOCGROUP  PS41310  Main  Program  Parts  List 


Main  Pgm 

Module 

Module 

Name 

Name 

Type 

TOTOPN 

ERRPRO 

External 

routine 

OPENX 

External 

routine 

TRMDML 

ERRPRO 

External 

routine 

CDS  01 

External 

routine 

TRMNAT 

External 

routine 

3.10.4  Module  Documentation 

The  following  documentation  describes  information 
which  is  specific  to  each  individual  module  in  the 
documentation  group  being  documented  in  this  specification. 
It  provides  a  compact  way  of  getting  information  that  would 
be  otherwise  buried  within  each  module's  source  code. 


The  specific  items  in  this  module  documentation  have  the 
following  meanings: 


NAME: 
PURPOSE : 

LANGUAGE : 


MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 

HOST: 

SUBSYSTEM: 


Name  of  program  Module. 

Purpose  of  Module  as  detailed  in  the 
source  code. 

Programming  language  source  code  is 
written  in. 

The  choices  are: 

VAX- 11  FORTRAN 

C  (I/S-1  Workbench  'C') 

VAX- 11  COBOL 

Whether  a  Program,  Subroutine,  or 
Function. 

Name  of  Source  File  from  file 
specification. 

Source  File  Extension  from  file 
specification. 

Whether  this  is  a  host-dependent 
routine  (VAX  or  IBM)  or  blank  if 
host-independent . 

IISS  sub-system  this  file  resides  in. 
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SUBDIRECTORY : 


Sub-directory  of  that  subsystem  in 
which  this  file  resides. 


DOCUMENTATION  GROUP:  Name  of  documentation  group  of  which 

this  source  file  is  a  member. 

DESCRIPTION:  A  description  of  the  module  as  otained 

from  the  source  code. 


ARGUMENTS:  The  arguments  with  which  this  routine 

is  called  if  it  is  a  Subroutine  or  a 
Function. 


INCLUDE  FILES: 


ROUTINES  CALLED: 


CALLED  DIRECTLY  BY: 


A  list  of  all  the  files  that  are 
included  into  this  module  as  well  as 
their  purposes. 

Subroutines  or  Functions,  either 
documented  or  external,  called  by 
this  module,  if  any. 

The  documented  routines  which  call 
this  module,  if  any. 


USED  IN  MAIN  PROGRAM (S) :  The  documented  Main  Programs  which 

contain  this  module  in  their  parts 
list  according  to  the  list  in  section 
3.10.3. 


The  Module  Documentation  is  arranged  alphabetically  according 
to  Module  Name. 


DOCGROUP  PS41310  Module  Documentation 


NAME:  CDFUNC 

PURPOSE:  DETERMINE  AP  NAME  GIVEN  THE  FUNCTION  AND  HOST 

LANGUAGE:  VAX- 11  COBOL 

SOURCE  FILE:  CDFUNC 

SOURCE  FILE  TYPE:  COB 

HOST: 

SUBSYSTEM:  CDM 
SUBDIRECTORY:  CDMR 


DESCRIPTION: 


-  PERFORM  A  TABLE  LOOK  UP  BASED  ON  THE  GIVEN 
HOST  NAME  AND  THE  FUNCTION  DESIRED. 

RETURN  THE  PROPER  AP  NAME. 


3-10 


PS  620341310 
30  September  1990 


ARGUMENTS ; 


FUNCT-IN 

HOST-IN 

TARGET-AP 

RET-STATUS 


INCLUDE  FILES: 


ERRCDM 

CHKCDM 

ERRPRO 


ROUTINES  CALLED: 


ERRPRO 


DOCGROUP  PS41310  Module  Documentation 


NAME:  CDLSC 

PURPOSE:  Dynamically  call  the  rp-main  and  return  to  drs 

LANGUAGE:  VAX- 11  COBOL 

SOURCE  FILE:  CDLSC 

SOURCE  FILE  TYPE:  COB 

HOST:  VAX 

SUBSYSTEM:  CDM 

SUBDIRECTORY:  CDMR 


DESCRIPTION: 


This  routine  is  called  from  the  drs  (cdsOl) 
to  do  the  cobol  dynamic  call  to  the  rp-main.  There 
is  an  ibmversion  of  this  routine  that  is  simply  a 
stub,  since  the  ibm  cannot  handle  standard  cobol 
that  does  dynamic  calls. 

10/2/89  -  CHANGED  TO  ALWAYS  CALL  RPMAIN.C  NO  MATTER  WHAT 
THE  LANGUAGE.  THIS  IS  SO  WE  WILL  NOT  LONGER  HAVE 
ANY  DYNAMIC  CALLS. 


DSPLY[X(10) ] 
DSPLY[XXX] 
DSPLY[X(10) ] 
DSPLYtX(5) ] 
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ARGUMENTS : 

QP-MOD-NAME 

DSPLY[X(5) ] 

LOG-CHAN 

DSPLY[999] 

RP-MSG-LTH 

DSPLY[9 (5) ] 

RP-MSG 

RECRD 

STD-RESPONSE 

RECRD 

RPMAIN-LANG 

DSPLY[X] 

RET-STATUS 

DSPLY[X(5) ] 

INCLUDE  FILES: 

ERRCDM 

ERRPRO 

ROUTINES  CALLED: 

RPMAIN 

ERRPRO 

DOCGROUP  PS41310  Module  Documentation 


NAME:  CDS 01 

PURPOSE:  THE  DISTRIBUTED  REQUEST  SUPERVISOR 

LANGUAGE:  VAX- 11  COBOL 

SOURCE  FILE:  CDS 01 

SOURCE  FILE  TYPE:  COB 

HOST:  VAX 

SUBSYSTEM:  CDM 

SUBDIRECTORY:  CDMR 


DESCRIPTION; 


-  THE  DRS  IS  THE  RUN  TIME  MONITOR 

OF  ALL  RUN  TIME  PROGRAMS  NECESSARY 

TO  FULFILL  A  NDML  REQUEST. 

MOD  REL  2.3: 

ADD  SUPPORT  FOR  "IN-LINE  CODE"  WHICH  MEANS  ONE  OF 
THE  REQUEST  PROCESSORS  MAY  BE  LINKED  IN  LOCALLY 
AND  ACCESSED  BY  A  COBOL  "DYNAMIC"  CALL.  ALSO 
EACH  AGGREGATOR  WILL  HAVE  AN  ADDITIONAL  CALL-LEVEL 
INTERFACE.  ADD  SUPPORT  FOR  USE  OF  THE  OUTER-JOIN 
AGGREGATOR  INSTEAD  OF  THE  NOT  IN  SET  AGGREGATOR. 

MOD  4/30/88  -  R.  E.  STEWART  -  ADDED  CODE  TO  HANDLE  SQLFORMS 
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ARGUMENTS : 


SS-NO-SUBTRANS 

DRS-ACTION 

SS-POOL 

CS-ACTION-LIST 

JQG 

JQG-ATTRIBUTE-PAIR-LIST 

USER-RFT 

CS -RESULTS -FILE 

CS -RESULTS -COUNT 

RET-STATUS 


DSPLY[999] 

DSPLY[X] 

RECRD 

RECRD 

RECRD 

RECRD 

RECRD 

DSPLY[X(80) ] 
DSPLY[9(6) ] 
DSPLY[X(5) ] 


INCLUDE  FILES: 


TCTABLE 

CITABLE 

RITABLE 

QITABLE 

SUBPROC 

RFTABLE 

STDRESP 

ERRCDM 

SRVRET 

FSMSG 

AGGMSG 

CSAL 

JQGTBL 

APL 

ERRPRO 

LNKEDGE 

DUMPCIT 

DUMPRIT 

DUMPAPL 

DUMPRFT 

DUMPJQG 

DMPCSAL 

ROUTINES  CALLED: 


ERRPRO 

SIGERR 

CDGTUSR 

WHTHST 

GETUSR 

CHKMSG 

RCV 

ASCTIM 

CDLSC 

NSEND 

ISEND 

CDFUNC 

CDJSl 

CDUSl 

CDOJSl 

DELFIL 

SIGABT 
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DOCGROUP  PS41310  Module  Documentation 


NAME:  TOTOPN 

PURPOSE:  CONTROL  OPENING  OF  TOTAL  DB  FILES 

LANGUAGE:  VAX- 11  COBOL 

SOURCE  FILE:  TOTOPN 

SOURCE  FILE  TYPE:  COB 

HOST: 

SUBSYSTEM:  CDM 
SUBDIRECTORY:  NDDL 


DESCRIPTION: 


BY  USING  A  GLOBAL  REALM  CONTAINING  ALL  FILES 
CURRENTLY  OPENED  BY  TOTAL  OF  THIS  PROCESS  AND 
A  LOCAL  REALM  OF  FILES  A  PARTICULAR  RP  NEEDS, 

ONLY  THE  NEW  FILES  NEED  BE  OPENED  AND  RECORDED 
IN  THE  GLOBAL  REALM  TABLE.  A  SINGLE  "OPENX" 

CALL  MAY  BE  ISSUED,  AND  EACH  FILE  SUCCESSFULLY 
OPENED  STORED  IN  THE  GLOBAL  REALM.  IF  ANY  FILE 
IS  FOUND  IN  ERROR,  A  MESSAGE  IS  LOGGED. 


ARGUMENTS : 


LOCAL-REALM 

GLOBAL-REALM 

TOTAL-STATUS 


RECRD 

RECRD 

DSPLY[X(4) ] 


INCLUDE  FILES: 


ERRCDM 

CHKCDM 

ERRPRO 


ROUTINES  CALLED: 


OPENX 

ERRPRO 
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DOCGROUP  PS41310  Module  Documentation 
NAME:  TRMDML 

PURPOSE:  TERMINATE  USE  OF  NDML  AND  NTM 

LANGUAGE:  VAX- 11  COBOL 

SOURCE  FILE:  TRMDML 

SOURCE  FILE  TYPE:  COB 

HOST: 

SUBSYSTEM:  CDM 
SUBDIRECTORY:  CDMR 

DESCRIPTION: 


-  THIS  MODULE  WILL  BE  USED  TO  SIGNAL  END  OF  ANY 
NDML  COMMAND  PROCESSING.  IT  WILL  SEND  A  SPECIAL 
CALL  TO  THE  DRS,  SO  THAT  IT  CAN  NOTIFY  EACH 
ACTIVE  RP  TO  DO  A  CLOSE  AND  TERMINATE  ITS 
PROCESSING.  WHEN  THE  DRS  RETURNS  AFTER  EACH  RP  IS 
DONE,  NTM  SERVICE  TRMNAT  WILL  BE  CALLED  TO  STOP  THE 
RUN.  NOTE,  THE  USER  WILL  NOT  NEED  TO  USE  TRMNAT. 


ARGUMENTS : 


TERMINATION-STATUS  DSPLY[X] 

INCLUDE  FILES: 


CHKCDM 

ERRCDM 

ERRPRO 

ROUTINES  CALLED: 


CDS  01 

TRMNAT 

ERRPRO 


DOCGROUP  PS41310  Module  Documentation 
NAME:  INTFTN 

PURPOSE:  CONVERT  INTEGER  VALUE  TO  CHARACTER  STRING  ** 

LANGUAGE:  VAX- 11  FORTRAN 

SOURCE  FILE:  INTFTN 

SOURCE  FILE  TYPE:  FOR 

HOST: 

SUBSYSTEM:  CDM 
SUBDIRECTORY:  CDMR 


DESCRIPTION 
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ARGUMENTS : 


1*4 

CHAR 


NUMBER 

CHAROT 


DOCGROUP  PS41310  Module  Documentation 
NAME:  CDGTUSR 

PURPOSE:  GET  USER  INFORMATION 

LANGUAGE:  C 

SOURCE  FILE:  CDGTUSR 

SOURCE  FILE  TYPE:  C 

HOST:  VAX 

SUBSYSTEM:  CDM 

SUBDIRECTORY:  CDMR 

DESCRIPTION: 


THIS  IS  A  VERSION  OF  THE  UI  ROUTINE  GTUINF,  MODIFIED  TO 
TO  USE  THE  GLOBAL  USER  NAME  AND  ROLE  NAME  STORED  BY 
THE  BATCH  VERSION  OF  NDDL.  IT  IS  CALLED  BY  THE  DRS 
INSTEAD  OF  THE  NTM  GETUSR  SERVICE  WHICH  DOESN'T  WORK 
WHEN  THERE  ARE  MULTIPLE  USERS  ON  THE  NTM  AT  THE  SAME 
TIME.  IF  THE  DRS  IS  USED  BY  SOME  OTHER  ROUTINE  THAN 
NDDL,  THIS  MAY  NOT  WORK  SINCE  THE  GLOBAL  USER  AND  ROL 
NAME  WONT  BE  SET  UP,  IF  IT  DOESNT  BLOW-UP,  THAT'S  OK 
SINCE  THE  DRS  IS  USING  THIS  AS  A  WORKAROUND  TO  A 
CDM  PATCH  TO  ALLOW  MULTIPLE  CDM'S  ON  THE  SAME  IISS  INSTANCE. 
CHECK  FOR  SPECIAL  SQLFORMS  FLAG  AND  SET  RCODE  TO  77777  IF 
FOUND 

SYNOPSIS 

FORTRAN  VOID  CDGTUSR (USRNAM,  USROLE,  RCODE) 

CHAR  USRNAM [] ; 

CHAR  USROLE [ ] ; 

CHAR  RCODE [ ] ; 

INPUTS/OUTPUTS : 

INPUTS : 

NONE 
OUTPUTS : 

USRNAM  -  USER'S  NAME 
USROLE  -  USER'S  ROLE 
RCODE  -  RETURN  CODE 
DESCRIPTION 

THIS  MODULE  WILL  RETURN  USER  NAME  AND  USER  ROLE  TO  CALLER 
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ARGUMENTS ; 


USRNAM 

USROLE 

RCODE 


CHAR  [] 
CHAR  [] 
CHAR  [] 


INCLUDE  FILES: 


STDTYP 

FPD 

FPCODE 

NDDL 

OK 

ROUTINES  CALLED: 


STRNCPY 

STRLEN 

MEMCPY 

STRNCMP 


DOCGROUP  PS41310  Module  Documentation 

NAME:  STRFILL 
PURPOSE: 

LANGUAGE:  C 
SOURCE  FILE:  STRFILL 
SOURCE  FILE  TYPE:  C 
HOST: 

SUBSYSTEM:  CDM 
SUBDIRECTORY:  CDMR 

ARGUMENTS : 


S  CHAR  [ ] 

T  CHAR  * 

N  INT 


ROUTINES  CALLED: 


STRNCPY 
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3.10.5  Include  File  Descriptions 

The  following  list  contains  a  purpose  and  description  of 
each  include  file  in  the  documentation  group  as  specified  in 
the  source  code.  The  language  it  is  written  in  is  also  given. 


DOCGROUP  PS41310  Include  File  Description 
FILE  NAME:  AGGMSG 

PURPOSE:  AGGREGATOR  INPUT  MESSAGE 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 


CONTAINS  THE  FORMAT  OF  THE  INPUT  MESSAGE  FOR  THE 
CDMP  AGGREGATORS 


DESCRIPTION  :- 


AGGREGATOR  INPUT  MESSAGE  FORMAT 
NIS  =  NOT  IN  SET 


DOCGROUP  PS41310  Include  File  Description 
FILE  NAME:  APL 

PURPOSE:  JOIN  QUERY  ATTRIBUTE  PAIR  LIST 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 


CONTAINS  INFORMATION  ABOUT  THE  JOIN 

ATTRIBUTES  FOR  NDML  SUBTRANSACTIONS 


DOCGROUP  PS41310  Include  File  Description 
FILE  NAME:  CHKCDM 

PURPOSE:  IISS  CDMP  CHECK  STATUS  CODES 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 


CONTAINS  ALL  STATUS  CODES  FOR  THE  * 

CDMP  MODULES  * 


3-18 


PS  620341310 
30  September  1990 


DOCGROUP  PS41310  Include  File  Description 

FILE  NAME;  CITABLE 

PURPOSE:  COST  INFORMATION  TABLE 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 


THIS  TABLE  IS  USED  BY  THE  DRS  TO 
TRACK  COSTS  OF  POSSIBLE  SUBTRANSACTIONS 


DOCGROUP  PS41310  Include  File  Description 
FILE  NAME:  CS 

PURPOSE:  DISPLAY  CONTENTS  OF  THE  COST  INFORMATION  TABLE 

LANGUAGE:  VAX-11  COBOL 

DESCRIPTION: 


DOCGROUP  PS41310  Include  File  Descriotion 
FILE  NAME;  CSAL 

PURPOSE:  CONCEPTUAL  SCI:::;MA  ACTION  LIST 

LANGUAGE;  VAX-11  COBOL 

DESCRIPTION; 


TABLE  TO  HOLD  CONCEPTUAL  DATA  ABOUT  THE  REQUEST 

NOTE!!!!!!  This  table  is  cloned  in  both  cdpre5  and  cdpre4 
so  any  changes  made  to  this  structure  needs  to 
be  made  in  these  cloned  versions.  Clone  version 
is  CSALX  for  CDPRE4. 

Any  changes  to  the  CS-ACTION-ENTRY  must  be 
reflected  in  CDPlOB  in  the  C  code  generation 
section.  The  length  of  CS-STRING2  has  been  hard 
coded  in  the  generated  C  code  in  paragraph 
2 lO-GEN-MOVE-OF-TABLES . 

THE  CONCEPTUAL  SCHEMA  ACTION  LIST 


NOTE  AGAIN 


■k-kicick 
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DOCGROUP  PS41310  Include  File  Description 
FILE  NAME:  DMPCSAL 

PURPOSE:  DISPLAYS  THE  CONTENTS  OF  THE  CS  ACTION  LIST 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 


DOCGROUP  PS41310  Include  File  Description 
FILE  NAME:  DUMPAPL 

PURPOSE:  DISPLAYS  THE  CONTENTS  OF  THE  ATTRIBUTE  PAIR  LIST 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 


DOCGROUP  PS41310  Include  File  Description 
FILE  NAME:  DUMPJQG 

PURPOSE:  DISPLAY  THE  CONTENTS  OF  THE  JQG  TABLE 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 


DOCGROUP  PS41310  Include  File  Description 
FILE  NAME:  DUMPRFT 

PURPOSE:  DISPLAY  THE  CONTENST  OF  THE  RFT  TABLE 

LANGUAGE:  VAX-11  COBOL 

DESCRIPTION: 
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DOCGROUP  PS41310  Include  File  Description 
FILE  NAME:  DUMPRIT 

PURPOSE:  DISPLAY  THE  CONTENTS  OF  THE  RIT  TABLE 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 


DOCGROUP  PS41310  Include  File  Description 


FILE  NAME:  ERRCDM 

PURPOSE:  IISS  ERROR  STATUS  CODES  FOR  CDMP  MODULES 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 


CONTAINS  ALL  ERROR  CODES  USED  BY  CDMP  * 

MODULES  FOR  ERROR  HANDLING  * 


DOCGROUP  PS41310  Include  File  Description 
FILE  NAME:  ERRPRO 

PURPOSE:  PROCESS  ERROR  INCLUDE  FILE 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 


DOCGROUP  PS41310  Include  File  Description 
FILE  NAME:  FPCODE 

PURPOSE:  FORM  PROCESSOR  RETURN  CODES 

LANGUAGE :  C 

DESCRIPTION: 
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DOCGROUP  PS41310  Include  File  Description 
FILE  NAME:  FPD 

PURPOSE:  FORM  PROCESSOR  DATA 

LANGUAGE :  C 

DESCRIPTION: 


DESCRIPTION 

DATA  DEFINITIONS  FOR  ALL  FORM  PROCESSOR  (INCLUDING 
MONITER) DATA. 


DOCGROUP  PS41310  Include  File  Description 
FILE  NAME:  JQGTBL 

PURPOSE:  JOIN  QUERY  GRAPH  TELLS  HOW  TO  CONNECT 

SUBTRANSACTIONS 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 


DOCGROUP  PS41310  Include  File  Description 
FILE  NAME:  LNKEDGE 

PURPOSE:  DETERMINE  DUPLICATE  EDGES  IN  THE  JQG 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 


DURING  JQG  COLLAPSING,  DUPLICATE  JQG  ENTRIES  MAY  RESULT 

WITH 

DIFFERENT  APL'S,  THIS  WILL  BE  EXECUTED  AT  THE  END  OF 

SENDS 

FOR  A  STAGE  AND  WILL  FIND  THE  DUPLICATE  EDGES  AND  HOOK  THE 
APL'S  TOGETHER  BEFORE  THE  CIT  IS  REBUILT  AT  THE  BEGINNING 
OF  THE  NEXT  STAGE. 


DOCGROUP  PS41310  Include  File  Description 

FILE  NAME:  NDDL 
PURPOSE : 

LANGUAGE :  C 

DESCRIPTION: 
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DOCGROUP  PS41310  Include  File  Description 
FILE  NAME:  OK 

PURPOSE:  GOOD  RETURN  CODE  VALUE  FOR  UI 

LANGUAGE :  C 

DESCRIPTION: 


DESCRIPTION 

CONTAINS  THE  VALUE  FOR  A  GOOD  RETURN  CODE 
FROM  THE  USER  INTERFACE 


DOCGROUP  PS41310  Include  File  Description 
FILE  NAME:  QITABLE 

PURPOSE:  REQUEST  PROCESSOR  INFORMATION  TABLE 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 


THIS  TABLE  WILL  TRACK  ALL  ACTIVE  REQUEST  PROCESSORS 
FOR  THE  DRS. 


QITABLE. INC 


DOCGROUP  PS41310  Include  File  Description 

FILE  NAME:  RFTABLE 

PURPOSE:  THE  RESULT  FIELD  TABLE 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 


CONTAINS  CONCEPTUAL  SCHEMA  INFORMATION  ABOUT 
THE  RESULTS  OF  AN  NDML  REQUEST 


THE  RESULT  FIELD  TABLE 

WHEN  CHANGING  THE  STRUCTURE  OF  THIS  TABLE 
BE  SURE  TO  CHANGE  THE  LAYOUT  IN  THE 
LINKAGE  SECTION  OF  THE  DRS  (CDSOl) 

WHICH  WAS  COPIED  FROM  THIS. 
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DOCGROUP  PS41310  Include  File  Description 
FILE  NAME:  RITABLE 

PURPOSE:  RIT-  RELATION  INFORMATION  TABLE 

LANGUAGE:  VAX-11  COBOL 

DESCRIPTION: 


USED  BY  THE  DRS  TO  KNOW  ABOUT  EACH  RELATION 
IN  A  TRANSACTION 


THIS  TABLE  MUST  HAVE  THE  SAME  NUMBER  OF  OCCURS 
AS  THE  SUBPROC.INC  SINCE  THEY  ARE  PARALLEL 
TABLES . 


DOCGROUP  PS41310  Include  File  Description 
FILE  NAME:  SRVRET 

PURPOSE:  MESSAGE  FOR  THE  FILE  SEND  UTILITY 

LANGUAGE:  VAX-11  COBOL 

DESCRIPTION: 


MESSAGE  FORMAT  FOR  THE  FILE  SEND  INPUT 


DOCGROUP  PS41310  Include  File  Description 
FILE  NAME:  STDRESP 

PURPOSE:  WS  DEFINITION  FOR  STANDARD  STATUS  VARIABLE 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 


THE  STANDARD  'PROCESS  COMPLETE'  MESSAGE 
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DOCGROUP  PS41310  Include  File  Description 
FILE  NAME:  STDTYP 

PURPOSE:  STANDARD  TYPE  DEFINITIONS 

LANGUAGE :  C 

DESCRIPTION: 


DESCRIPTION 
THIS  FILE 
AVAILABLE: 

FLOAT 

DOUBLE 


ENSURES  THAT  THE  FOLLOWING  STANDARD  TYPES  ARE 

-  SINGLE  PRECISION  FLOAT 

-  DOUBLE  PRECISION  FLOAT 


LONG  -  32  BIT  (OR  LARGER)  SIGNED  INTEGER 

LBITS  -  32  BITS  (OR  MORE)  FOR  BIT  MANIPULATION 

INT  -  NATURAL  SIZE  SIGNED  INTEGER 

UNSIGNED  -  NATURAL  SIZE  UNSIGNED  INTEGER 

BOOL  -  NATURAL  SIZE  LOGICAL  (ZERO  /  NON-ZERO  ONLY) 


SHORT 

USHORT 

BITS 


16  BIT  (OR  LARGER)  SIGNED  INTEGER 
16  BIT  (OR  LARGER)  UNSIGNED  INTEGER 
16  BITS  (OR  MORE)  FOR  BIT  MANIPULATION 


CHAR 

TINY 

UTINY 

TBITS 

TBOOL 


SINGLE  MACHINE  CHARACTER  (REAL  CHARACTERS 
ALWAYS  POSITIVE) 

8  BIT  (OR  LARGER)  SIGNED  INTEGER 
8  BIT  (OR  LARGER)  UNSIGNED  INTEGER 
8  BITS  (OR  MORE)  FOR  BIT  MANIPULATION 
8  BIT  (OR  LARGER)  LOGICAL  (ZERO  /  NON-ZERO 
ONLY) 


METACHAR  -  16  BIT  (OR  LARGER)  AUGMENTED  CHARACTER 

(SIGNED) 


VOID  -  FUNCTION  THAT  RETURNS  NO  VALUE 


FORTRAN  -  STORAGE  CLASS  FOR  FOREIGN  (NON-C)  ROUTINES 

OR  C  ROUTINES 

WHICH  ARE  CALLABLE  FROM  FOREIGN  ROUTINES 


SINCE  NOT  ALL  COMPILERS  SUPPORT  USHORT,  TINY,  AND  UTINY, 
THE  FUNCTIONS 

USHORT ( ) ,  TINY ( ) ,  AND  UTINY ( )  SHOULD  BE  USED  WHENEVER 
REFERENCING  THEM. 
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IN  ADDITION, 
LURSHIFT(N 
MAX (A,  B) 
MIN (A,  B) 
ABS (A) 
STRASN(A, 
NULL 
TRUE 
FALSE 
SUCCESS 

FAILURE 


THE  FOLLOWING  UTILITY  MACROS  ARE  DEFINED: 

,  B)  -  UNSIGNED  LONG  RIGHT  SHIFT 

-  MAXIMUM  OF  A  AND  B 

-  MINIMUM  OF  A  AND  B 

-  ABSOLUTE  VALUE  OF  A 

B)  -  TRANSPORTABLE  A  =  B  FOR  STRUCTURES 

-  NULL  POINTER  VALUE  (0) 

-  1 
-  0 

-  EXIT (SUCCESS)  INDICATES  SUCCESSFUL 

COMPLETION 

-  EXIT (FAILURE)  INDICATES  ERRORS 


THE  FOLLOWING  SYMBOLS  SHOULD 
COMPILER  BEING  USED: 


BE  DEFINED  BASED  ON  THE 


USHORT 
TINY 
UTINY 
UNSIGNED  CHAR 
VOID 
FORTRAN 
STRASN 
SUCCESS 
FAILURE 


COMPILER  SUPPORTS  UNSIGNED  SHORT 
COMPILER  TREATS  CHAR  AS  SIGNED 
CHAR  IS  SIGNED  AND  COMPILER  SUPPORTS 

COMPILER  SUPPORTS  VOID 
COMPILER  SUPPORTS  FORTRAN 
DEFINE  APPROPRIATE  MACRO 
DEFINE  APPROPRIATE  VALUE  IF  NOT  0 
DEFINE  APPROPRIATE  VALUE  IF  NOT  1 


DOCGROUP  PS41310  Include  File  Description 
FILE  NAME:  SUBPROC 

PURPOSE:  SUBTRANSACTION  PROCESSES  ID  TABLE 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 


THIS  TABLE  MUST  HAVE  THE  SAME  NUMBER  OF  OCCURS 
AS  THE  RITABLE.INC  AND  QITABLE.INC  SINCE  THEY  ARE 
PARALLEL  TABLES. 
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DOCGROUP  PS41310  Include  File  Description 
FILE  NAME;  TCTABLE 

PURPOSE:  TRANSMISSION  COST  TABLE 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 


HOLDS  RELATIVE  COST  OF  TRANSMISSION/PROCESSING 
FILE  TRANSFERS/JOINS  ON  THE  NETWORK  AND  IS  USED  AS 
A  BASIS  OF  STAGER/SCHEDULER  OPTIMIZATION  ALGORITHMS 


THESE  ARE  THE  EXPERIMENTAL  VALUES  FOR  THE  TCT: 


3.10.6  Hierarchy  Chart 


1 

+ - 4-  + - +  + - +  + - +  + - + 

|CDFUNC|  |CDLSC|  |TOTOPN|  |TRMDML|  |STRFILL| 

+ — + - +  + - 2+  + — + - +  + - 3+  + - + - + 

I 

+ - + - + 

I  I 

+ - + - +  + - + - +  + - + - +  + - + - + 

1 ERRPRO  1  1 OPENX  )  ) ERRPRO  |  | STRNCPY  | 

+ - 4-  + - +.  4 - +  + - + 


2 

+ - + 

|CDLSC| 

+ — + — + 

I 

+ - + - + 

I  I 

+ - + - +  + - + - + 

I RPMAIN  I  I ERRPRO  | 

+ - +  + - + 
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+ - + 

I TRMDML 1 
+ — + + 


+ - + - + 

I  I  I 

+~— — j — — — +  +— — i- - — + 

|CDS01  I  ITRMNAT  (  | ERRPRO  | 

+ - + - +  + - +  + - + 

1 

+ - + - + - + - + 

II  III 

+  ~~~+“~“~+  -f  — — — 4-  — —  — — +  ^ - -.—4-  —— - h  +  —  1-  H - 1 - h 

I ERRPRO  1  ISIGERR  |  | CDGTUSR  )  | WHTHST  [  | (CONT) | 

+ - +  + - +  + - + - +  + - +  + - 4+ 

I 

+ - + - + - + - + 


+ - + - + 

I STRNCPY  I 
+ - + 


+ - + - + 

( STRLEN  I 
+ - + 


+ - + - + 

I MEMCPY  I 
+ - + 


+ - + - + 

I STRNCMP  I 
+ - + 


4 

+ - + 

ICDSOl  I 
+ - + - + 

I 

+ - ++ - + 


+ — + - +  + - + - +  + - + - + 

I (CONT) I  jGETUSR  |  | CHKMSG  [ 

+ - 3+  + - +  + - + 


CDFUNC . 1 

CDGTUSR  ....  3 

CDLSC . 2 

CDSOl  . 3 

CHKMSG 

ERRPRO 

GETUSR 

MEMCPY 

OPENX 

RPMAIN 

SIGERR 


STRFILL . 1 

STRLEN 

STRNCMP 

STRNCPY 

TOTOPN . 1 

TRMDML . 3 

TRMNAT 

WHTHST 
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3.11  Program  Listings  Comments 

This  information  is  contained  in  the  Module  Descriptions  in 
section  3.10. 
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SECTION  4 

QUALITY  ASSURANCE  PROVISIONS 


4 . 1  Introduction  and  Definitions 

"Testing”  is  a  systematic  process  that  may  be  preplanned 
and  explicitly  stated.  Test  techniques  and  procedures  may  be 
defined  in  advance,  and  a  sequence  of  test  steps  may  be 
specified.  "Debugging"  is  the  process  of  isolation  and 
correction  of  the  cause  of  an  error. 

"Antibugging"  is  defined  as  the  philosophy  of  writing 
programs  in  such  a  way  as  to  make  bugs  less  likely  to  occur  and 
when  they  do  occur,  to  make  them  more  noticeable  to  the 
programmer  and  the  user.  In  other  words,  as  much  error  checking 
as  IS  practical  and  possible  in  each  routine  should  be 
performed. 


4 . 2  Computer  Programming  Test  and  Evaluation 

The  quality  assurance  provisions  for  test  consists  of  the 
normal  testing  techniques  that  are  accomplished  during  the 
construction  process.  They  consist  of  design  and  code 
walk-throughs,  unit  testing,  and  integration  testing.  These 
tests  are  performed  by  the  design  team.  Structured  design, 
design  walk-through  and  the  incorporation  of  "antibugging" 
facilitate  this  testing  by  exposing  and  addressing  problem  areas 
before  they  become  coded  "bugs." 
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